home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 47.7z / BS1 part 47 / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].7z / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].adf / apa.lzh.parta / hlp_arexx7 < prev    next >
Text File  |  1994-04-05  |  27KB  |  1,104 lines

  1. \ApAssist
  2. \: - This is the Quick Help for the ARexx in IM R/t -
  3. \: ----------------------------------------------------------
  4. \:   Written by David E. Patterson
  5. \: ----------------------------------------------------------
  6.  
  7. \font topaz.font 8
  8. \tc 1
  9. \wr
  10. \lj
  11. \dd "imh_descriptor"
  12.  
  13. \index "hlp_arexx2/dedither-gadgets"
  14. \toc "imh_toc/toc"
  15. \help "aa_help/help
  16.  
  17. \node "edge"
  18. \title "Edge Line"
  19. \next "ehlp"
  20. \prev "hlp_arexx6/dynamic"
  21. \{ \tc 15 Edge \} - Creates line art over an existing image.
  22.         
  23. \nw    
  24. Usage - '\{ \tc 15 <effect> <threshold> <monochrome> <blackline>\} '
  25.     
  26. \{ \tc 15 Effect:      0 to 100%
  27. Threshold:   0 to 255
  28. Monochorome: 0 = No, 1 = Yes
  29. Blackline:   0 = No, 1 = Yes\}
  30.     
  31. \{ \ts bu Sample Script\} :
  32.     
  33. 'area'; 
  34. options results;
  35. 'askprop Effect: 50 0 100';
  36. effect = result;
  37. 'askprop Threshold: 127 0 255';
  38. threshold = result;
  39. 'askyn "No Monochorme" "Monochorme"';
  40.  mono = result;
  41. 'askyn "White Line" "Black Line"';
  42. line = result;
  43. options;
  44. '\{ \tc 15 edge\} ' effect threshold mono line;
  45.     
  46. * User Interface: \{ \tc 15 Process Panel
  47.                       Special Effects
  48.                           Edge Line\}
  49.  
  50. \endnode
  51.  
  52. \node "ehlp"
  53. \title "Ehlp"
  54. \next "emboss"
  55. \prev "edge"
  56. \{ \tc 15 Ehlp \} - Returns a text string when passed any integer number.
  57.  
  58. \nw    
  59. Usage: '\{ \tc 15 ehlp <return code>\} ';
  60.     
  61. \{ \ts bu Sample Script\} :
  62.     
  63. 'colkeymaxrub';
  64. if rc ~=0 then do
  65.  options results;
  66.  '\{ \tc 15 ehlp\} ' rc;
  67.  error = result;
  68.  options;
  69.  say error;
  70.  exit 0;
  71. end
  72.  
  73. \endnode
  74.  
  75. \node "emboss"
  76. \title "Emboss"
  77. \next "entire"
  78. \prev "ehlp"
  79. \{ \tc 15 Emboss \} - Embosses the secondary buffer into the primary buffer.
  80.     
  81.     
  82. \nw    
  83. Usage - '\{ \tc 15 emboss <contrast>\} ' 
  84.     
  85. \{ \tc 15 Contrast: 0 to 100\}
  86.     
  87. \{ \ts bu Sample Script\} :
  88.     
  89. options results;
  90. 'askprop Contrast: 50 0 100';
  91. contrast = result;
  92. options;
  93. '\{ \tc 15 emboss\} ' contrast;
  94.    
  95. See Also: \{ \ts b \link "punch" "hlp_arexx10/punch" \}
  96.  
  97. * User Interface: \{ \tc 15 Compose Panel
  98.                       Special Compositions
  99.                           Emboss\}
  100.  
  101. \endnode
  102.  
  103. \node "entire"
  104. \title "Entire"
  105. \next "explode"
  106. \prev "emboss"
  107. \{ \tc 15 Entire \} - Selects entire image for future operations.
  108.  
  109. \nw    
  110. Usage - '\{ \tc 15 entire\} '
  111.     
  112. \{ \ts bu Sample Script\} :
  113.    
  114. '\{ \tc 15 entire\} ';
  115. 'contrast 50';
  116.     
  117. See Also: \{ \ts b \link "oval    " "hlp_arexx9/oval" 
  118.           \link "rectarea" "hlp_arexx10/rectarea"\}
  119.  
  120. \endnode
  121.  
  122. \node "explode"
  123. \title "Explode"
  124. \next "fadebrush"
  125. \prev "entire"
  126. \{ \tc 15 Explode \} - Creates an exploding or imploding motion blur.
  127.  
  128. \nw    
  129. Usage - '\{ \tc 15 explode <direction> <amount>\} '
  130.     
  131. \{ \tc 15 Direction: 0 = Explode, 1 = Implode\}
  132. \{ \tc 15 Amount:    0 - 100\}
  133.     
  134. \{ \ts bu Sample Script\} :
  135.     
  136. options results;
  137. 'askyn Outwards Inwards';
  138. direction = result;
  139. 'askprop Amount: 50 0 100';
  140. amount = result;
  141. options;
  142. '\{ \tc 15 explode\} ' direction amount;
  143.     
  144.     
  145. * User Interface: \{ \tc 15   Process Panel
  146.                        Geometric Transformations
  147.                           Explode/Implode\}
  148.  
  149. \endnode
  150.  
  151. \node "fadebrush"
  152. \title "Fade Brush"
  153. \next "fadelength"
  154. \prev "explode"
  155. \{ \tc 15 Fadebrush \} - This control will set the type od fade brush to be
  156. used for painting.  You can select a fade in, fade out, fade thru, or no fade
  157. at all.  The fade amount is set using the fadelength command.
  158.  
  159. \nw    
  160. Usage - '\{ \tc 15 fadebrush IN/OUT/THRU/OFF\} '
  161.  
  162. \{ \ts bu Sample Script\} :
  163. /* arexx fade length Example */
  164. address('IM_Port');
  165. 'newline';
  166. 'linemode brush';
  167. 'autosize off';
  168. 'fadebrush OUT';
  169. 'fadelength 75';
  170. '\{ \tc 15 fadebrush OUT\} ';
  171. 'move 0 0';
  172. 'draw 320 400';
  173. 'stroke';
  174. 'finish';
  175.  
  176. * User Interface: \{ \tc 15   Paint Panel
  177.                        Draw Mode
  178.                            Fade In/Fade Out/Fade Thru\}
  179.  
  180. \endnode
  181.  
  182. \node "fadelength"
  183. \title "Fade Length"
  184. \next "false"
  185. \prev "fadebrush"
  186. \{ \tc 15 Fadelength \} - This command is used to set the fade length for
  187. the fade out, in, and thru draw modes.  The fade length is a pecentage value
  188. ranging from 0 to 100 percent.  A setting of 0% will cause there to be no
  189. line drawn, and a setting of 100% will cause the entire line to be drawn.
  190.  
  191. \nw    
  192. Usage - '\{ \tc 15 fadelength <length>\} '
  193.  
  194. \{ \ts bu Sample Script\} :
  195. /* arexx fade length Example */
  196. address('IM_Port');
  197. 'newline';
  198. 'linemode brush';
  199. 'autosize off';
  200. 'fadebrush OUT';
  201. '\{ \tc 15 fadelength 75\} ';
  202. 'move 0 0';
  203. 'draw 320 400';
  204. 'stroke';
  205. 'finish';
  206.  
  207. * User Interface: \{ \tc 15   Paint Panel
  208.                        Draw Mode
  209.                            Fade Length\}
  210.                            
  211. \endnode
  212.  
  213. \node "false"
  214. \title "False"
  215. \next "fchide"
  216. \prev "fadelength"
  217. \{ \tc 15 False \} - False colors selected region.
  218.     
  219. Swaps red, green, and blue color components in a selected region. The first
  220. time \{ \tc 15 False \} is applied, red becomes green, green becomes blue,
  221. and blue becomes red.
  222.     
  223. \nw
  224.     Original    First Application   Second Application  Third Application
  225.     
  226.      Red     ->     Green     ->         Blue       ->        Red   
  227.      Green   ->     Blue      ->         Red        ->        Green
  228.      Blue    ->     Red       ->         Green      ->        Blue
  229.     
  230.     
  231. Usage - '\{ \tc 15 false\} '
  232.     
  233. \{ \ts bu Sample Script\} :
  234.    
  235. 'area';
  236. '\{ \tc 15 false\} ';
  237.     
  238. * User Interface: \{ \tc 15   Process Panel
  239.                        Special Effects
  240.                            False Color\}
  241.  
  242. \endnode
  243.  
  244. \node "fchide"
  245. \title "fchide"
  246. \next "fcredraw"
  247. \prev "false"
  248. \{ \tc 15 FChide \} - This will hide the current FireCracker screen.
  249.  
  250. It is important to remember to retarget the display to the FireCracker or
  251. change the display mode to the FireCracker.
  252.  
  253. \nw
  254. Usage - '\{ \tc 15 fchide\} '
  255.     
  256. \{ \ts bu Sample Script\} :
  257.    
  258. '\{ \tc 15 fchide\} ';
  259.  
  260. \endnode
  261.  
  262. \node "fcredraw"
  263. \title "fcredraw"
  264. \next "fcshow"
  265. \prev "fchide"
  266. \{ \tc 15 FCredraw \} - This will redraw the current FireCracker screen.
  267.  
  268. It is important to remember to retarget the display to the FireCracker or
  269. change the display mode to the FireCracker.
  270.  
  271. \nw
  272. Usage - '\{ \tc 15 fcredraw\} '
  273.     
  274. \{ \ts bu Sample Script\} :
  275.    
  276. '\{ \tc 15 fcredraw\} ';
  277.  
  278. \endnode
  279.  
  280. \node "fcshow"
  281. \title "fcshow"
  282. \next "filerequest"
  283. \prev "fcredraw"
  284. \{ \tc 15 FCredraw \} - This will show the current FireCracker screen.
  285.  
  286. It is important to remember to retarget the display to the FireCracker or
  287. change the display mode to the FireCracker.
  288.  
  289. \nw
  290. Usage - '\{ \tc 15 fcshow\} '
  291.     
  292. \{ \ts bu Sample Script\} :
  293.    
  294. '\{ \tc 15 fcshow\} ';
  295.  
  296. \endnode
  297.  
  298. \node "filerequest"
  299. \title "File Request"
  300. \next "fillmode"
  301. \prev "fcshow"
  302. \{ \tc 15 Filerequest \} - Calls a file requester.
  303.  
  304. Calls a file requestor allowing the user to select a file.  If the requestor
  305. is cancelled it returns the string \{ \ts b FR_CANCELLED\} . 
  306.     
  307. \nw    
  308. Usage - '\{ \tc 15 filerequest <path> <name> <extension> <prompt>\} '
  309.     
  310. \{ \tc 15 Prompt: Limited to 15 characters\}
  311.     
  312. \{ \ts bu Sample Script\} :
  313.     
  314. '\{ \tc 15 filerequest "dh0:" "default" ".24" "Load Image"\} ';
  315.  
  316. \endnode
  317.  
  318. \node "fillmode"
  319. \title "Fill Mode"
  320. \next "finish"
  321. \prev "filerequest"
  322. \{ \tc 15 Fillmode \} - The fillmode control is used to select one of
  323. Imagemaster 32 fill modes.  Some of these modes will require a secondary
  324. buffer, and others require ranges.  Once a mode has been selected, it will
  325. remain current until another fill mode is selected by the script or by the
  326. user in Imagemaster.
  327.  
  328. \nw
  329. Usage - '\{ \tc 15 fillmode <mode>\} '
  330.  
  331. Where mode can be any of the following fill modes:
  332.  0 or 'Solid'    = Solid Color Fill
  333.  1 or 'Hor'      = Horizontal Range Fill
  334.  2 or 'Vert'     = Vertical Range Fill
  335.  3 or 'HWarp'    = Horizontal Warp Range Fill
  336.  4 or 'VWarp'    = Vertical Warp Range Fill
  337.  5 or 'Radial'   = Radial Range Fill
  338.  6 or 'Tile'     = Brush Tile
  339.  7 or 'BTile'    = Brick Brush Tile
  340.  8 or 'Warp'     = Brush Warp
  341.  9 or 'Bwarp'    = Brick Brush Warp 
  342. 10 or 'Outline'  = Outline Range
  343. 11 or 'Inner'    = Inner Outline
  344. 12 or 'HCyl'     = Horizontal Cylinder Warp
  345. 13 or 'VCyl'     = Vertical Cylinder Warp
  346. 14 or 'Angle'    = Angled Range
  347. 15 or 'Dualh'    = Dual Horizontal Range
  348. 16 or 'Dualv'    = Dual Vertical Range
  349. 17 or 'Dualhw'   = Dual Horizontal Warp Range
  350. 18 or 'Dualvw'   = Dual Vertical Warp Range
  351. 19 or 'Poly'     = Poly Range
  352. 20 or 'Emboss'   = Brush Emboss
  353. 21 or 'BEmboss'  = Brick Emboss
  354. 22 or 'Tint'     = Tint
  355. 23 or 'Sat'      = Saturation
  356. 24 or 'Bright'   = Bright
  357. 25 or 'Anti'     = Anti-Alias
  358. 26 or 'Rip'      = Remove Isolated Pixel
  359. 27 or 'Lowpass'  = Lowpass Filter Brush
  360. 28 or 'Sharpen'  = Sharpen Filter Brush
  361. 29 or 'NTSC'     = NTSC Brush
  362. 30 or 'Rub'      = Rub Thru Brush
  363. 31 or 'CRub'     = Chroma Rub Thru Brush
  364. 32 or 'LRub'     = Luma Rub Thru Brush
  365.  
  366. \{ \ts bu Sample Script\} :
  367. /* arexx areafill Example */
  368. address('IM_Port');
  369. '\{ \tc 15 fillmode hor\} '; 
  370. 'area';
  371. 'areafill';
  372. 'finish';
  373.  
  374. * User Interface: \{ \tc 15    Paint Panel
  375.                         Fill Mode\}
  376.  
  377. \endnode
  378.  
  379. \node "finish"
  380. \title "Finish"
  381. \next "fntsc"
  382. \prev "fillmode"
  383. \{ \tc 15 Finish \} - Indicates that all operations have been completed.
  384.  
  385. Indicates the completion of a script.  Essential at the end of Multi-Frame
  386. processing scripts.  If '\{ \tc 15 finish\} ' is omitted, the Multi-Frame
  387. Sequence will only process the first frame.  
  388.  
  389. \nw    
  390. Usage - '\{ \tc 15 finish\} '
  391.     
  392. \{ \ts bu Sample Script\} : 
  393.     
  394. 'entire';       
  395. 'contrast 50';
  396. '\{ \tc 15 finish\} ';  
  397.  
  398. \endnode
  399.  
  400. \node "fntsc"
  401. \title "FNTSC"
  402. \next "forcefront"
  403. \prev "finish"
  404. \{ \tc 15 Fntsc \} - Filters the image according to NTSC broadcast standards.
  405.  
  406. Selected region is analyzed to create an effective sample rate, the image
  407. area is then smoothed.  The more pixels in the image, the greater the
  408. smoothing effect.  Luma and chroma elements are filtered seperately. 
  409.     
  410. \nw    
  411. Usage - '\{ \tc 15 fntsc\} '
  412.     
  413. \{ \ts bu Sample Script\} :
  414.     
  415. 'area';
  416. '\{ \tc 15 fntsc\} ';
  417.     
  418. * User Interface: \{ \tc 15    Process Panel
  419.                         Filters
  420.                            FNTSC Filter\}
  421.  
  422. \endnode
  423.  
  424.  
  425. \node "forcefront"
  426. \title "Force Imagemaster R/t to Front
  427. \next "forcewbfront"
  428. \prev "fntsc"
  429. \{ \tc 15 Forcefront \} - Forces Imagemaster R/t to front (ignores
  430. autoactivate).
  431.  
  432. \nw    
  433. Usage:  '\{ \tc 15 forcefront\} ';
  434.     
  435.     
  436. See Also: \{ \ts b \link "forcewbfront" "hlp_arexx7/forcewbfront" 
  437.           \link "imtofront   " "hlp_arexx7/imtofront"
  438.           \link "tofront     " "hlp_arexx11/tofront"\}
  439.                  
  440. \endnode
  441.  
  442. \node "forcewbfront"
  443. \title "Force Work Bench to Front"
  444. \next "gadgets"
  445. \prev "forcefront"
  446. \{ \tc 15 Forcewbfront \} - Forces Work Bench to front (ignores autoactivate).
  447.  
  448. \nw
  449. Usage:  'forcewbfront';
  450.     
  451. See Also: \{ \ts b \link "imtofront " "hlp_arexx7/imtofront"
  452.           \link "tofront   " "hlp_arexx11/tofront"\}
  453.     
  454. \endnode
  455.  
  456. \node "gadgets"
  457. \title "Gadgets"
  458. \next "gamma"
  459. \prev "forcewbfront"
  460. \{ \tc 15 Gadgets \} - Prompts the user with a list of gadgets.
  461.  
  462. Prompts the user with a list of up to 20 gadgets.  Each gadget has two lines
  463. of text.
  464.     
  465. \nw
  466. Usage - '\{ \tc 15 gadgets "First Line Gadget 1","Second Line of Gadget 1",
  467.                  "First Line Gadget 2","Second Line of Gadget 2",    
  468.                  "First Line Gadget 3","Second Line of Gadget 3"\} ';
  469.     
  470. \{ \ts bu Sample Script\} :
  471.     
  472. options results;
  473. '\{ \tc 15 gadgets "Add Red","To Entire Area","Add Green",
  474. "To the Entire Area" "Add Blue","To Entire Area"\} ';
  475.    selection = result;
  476.    options;    
  477.   if selection = 1 then do
  478.       'entire';
  479.       'addasr';
  480.       exit 0;
  481.       End;
  482.   if selection = 2 then do
  483.       'entire';
  484.       'addasg';
  485.        exit 0;
  486.       End;
  487.   if selection = 3 then do
  488.       'entire';
  489.       'addasb';
  490.       exit 0;
  491.       End;
  492.  
  493. \endnode
  494.  
  495. \node "gamma"
  496. \title "Gamma"
  497. \next "gaus"
  498. \prev "gadgets"
  499. \{ \tc 15 Gamma \} - Changes the gamma for a selected area.
  500.  
  501. Brightens and darkens pixels around a center value (128) based on how bright
  502. or dark the pixel is initially.  It is a contrast function that emulates the
  503. way the eye responds to light.
  504.     
  505. \nw    
  506. Usage - '\{ \tc 15 gamma <%>\} '
  507.  
  508. \{ \tc 15 Percent of change: from -200 to 200\}
  509.     
  510. \{ \ts bu Sample Script\} :
  511.     
  512. 'area';
  513. options results;
  514. 'askprop Effect: 0 -200 200'
  515. effect = result';
  516. options;
  517. '\{ \tc 15 gamma\} 'effect;
  518.  
  519. See Also: \{ \ts b \link "contrast" "hlp_arexx6/contrast"\}
  520.     
  521. * User Interface: \{ \tc 15   Process Panel
  522.                         Standard Adjustments
  523.                             Gama\}
  524.     
  525. \endnode
  526.  
  527. \node "gaus"
  528. \title "Gaussian Blur"
  529. \next "geog"
  530. \prev "gamma"
  531. \{ \tc 15 Gaussian \} - Creates a Gaussian Blur in the selected region.
  532.     
  533. The gaussian blur, or Blur in the Filters panel, is a radius variable
  534. smoothing filter.  This filter has a specified radius which can range from 1
  535. to 20 pixels, a setting of less than one will produce no change.  It is
  536. important to remember that as the radius increases the total amount of
  537. computational time needed for the operation will also increase.  This blur is
  538. useful for creating soft edges on images, and many other blurred or soft
  539. edged effects.  It is strongly suggested that you use the \{ \ts b askfloat
  540. \} ARexx command instead of the \{ \ts b askprop \} command.  This will allow
  541. you to specify decimal numbers for the gaussian blur radius.
  542.  
  543. \nw    
  544. Usage - '\{ \tc 15 gaussian <radius>\} '
  545.     
  546. \{ \tc 15 Radius: 1.0 to 20.0 \} - You can specify a radius greater than 20,
  547. but it is not recommended.
  548.     
  549. \{ \ts bu Sample Script\} :
  550.     
  551. 'area';
  552. options results;
  553. 'askfloat Radius: 3.5 1.0 20.0 .1'; 
  554. radius = result;
  555. options;
  556. '\{ \tc 15 gaussian\} ' radius;
  557.     
  558. * User Interface: \{ \tc 15  Process Panel
  559.                        Filters 
  560.                            Blur\}
  561.  
  562. \endnode
  563.  
  564. \node "geog"
  565. \title "Geographic Elevation"
  566. \next "getaspect"
  567. \prev "gaus"
  568. \{ \tc 15 Geog \} - Creates an effect similar to a geographic relief map.
  569.     
  570. This effect uses the average intensity passed in the parameter \{ \ts b
  571. sealevel \} and transforms lower intensities into shades of blue.  The lower
  572. the intensity the darker the blue will be.  Intensities above the sealevel
  573. parameter will be represented in green, brown and finally white.
  574.     
  575. \nw    
  576. Usage - '\{ \tc 15 geog <sealevel>\} '
  577.     
  578. \{ \tc 15 Sea Level: 0 to 255\}
  579.     
  580. \{ \ts bu Sample Script\} :
  581.     
  582. 'area';
  583. options results;
  584. 'askprop Sealevel: 127 0 255'; 
  585. sealevel = result;
  586. options;
  587. '\{ \tc 15 geog\} ' sealevel;
  588.     
  589. See Also: \{ \ts b \link "shgeog" "hlp_arexx11/shgeog"\}
  590.     
  591. * User Interface: \{ \tc 15  Process Panel
  592.                        Special Effects 
  593.                            Geographic Elevations\}
  594.  
  595. \endnode
  596.  
  597. \node "getaspect"
  598. \title "Getaspect"
  599. \next "getblend"
  600. \prev "geog"
  601. \{ \tc 15 Getaspect \} - Reports aspect ratio of an image.
  602.  
  603. \nw    
  604. Usage - '\{ \tc 15 getaspect <buffernumb>\} '
  605.        
  606. \{ \ts bu Sample Script\} :
  607.      
  608. options results;
  609. 'current';
  610. info = result;
  611. parse var info
  612. bname','bnumber','xdim','ydim','xdimydim','memused','parentname',
  613.   'parentnumber;
  614. '\{ \tc 15 getaspect\} ' bnumber; 
  615. options;   
  616.  
  617. \endnode
  618.  
  619. \node "getblend"
  620. \title "Get Blend"
  621. \next "getdpi"
  622. \prev "getaspect"
  623. \{ \tc 15 Getblend \} - Returns the blend curve value at the specified
  624. position.
  625.     
  626. \nw    
  627. Usage - '\{ \tc 15 getblend <direction> <position>\} '
  628.     
  629. \{ \tc 15 Direction:  1 = up, 2 = right, 3 = down, 4 = left
  630. Position:   0 to 255 (0 = edge, 255 = center)\}
  631.     
  632. \{ \ts bu Sample Script\} :
  633.     
  634. options results;
  635. '\{ \tc 15 getblend 2 200\} ';
  636. blend = result;                 
  637. options;
  638. 'merge';
  639.     
  640. \endnode
  641.  
  642. \node "getdpi"
  643. \title "Getdpi"
  644. \next "greenadj"
  645. \prev "getblend"
  646. \{ \tc 15 Getaspect \} - Reports the DPI of an image.
  647.  
  648. \nw    
  649. Usage - '\{ \tc 15 getdpi <buffernumb>\} '
  650.        
  651. \{ \ts bu Sample Script\} :
  652.      
  653. options results;
  654. 'current';
  655. info = result;
  656. parse var info
  657. bname','bnumber','xdim','ydim','xdimydim','memused','parentname',
  658.   'parentnumber;
  659. '\{ \tc 15 getdpi\} ' bnumber; 
  660. options;   
  661.  
  662. \endnode
  663.  
  664. \node "greenadj"
  665. \title "Green Adjust"
  666. \next "greencont"
  667. \prev "getblend"
  668. \{ \tc 15 Greenadj \} - Changes the green brightness of a selected area.
  669.  
  670. \nw    
  671. Usage - '\{ \tc 15 greenadj <amount>\} '
  672.     
  673. \{ \tc 15 Amount: 0 - 100\}
  674.     
  675. \{ \ts bu Sample Script\} :
  676.     
  677. 'area';
  678. '\{ \tc 15 greenadj 89\} ';
  679.     
  680. See Also: \{ \ts b \link "blueadj" "hlp_arexx5/blueadj"      
  681.           \link "redadj " "hlp_arexx10/redadj"\}
  682.              
  683. * User Interface: \{ \tc 15    Process Panel
  684.                          R,G,B Corrections            
  685.                               Green\}
  686.  
  687. \endnode
  688.  
  689. \node "greencont"
  690. \title "Green Contrast"
  691. \next "gray"
  692. \prev "greenadj"
  693. \{ \tc 15 Greencont \} - Changes the green contrast for a selected area.
  694.  
  695. \nw    
  696. Usage - '\{ \tc 15 greencont <amount>\} '
  697.     
  698. \{ \tc 15 Amount: 0 - 100\}
  699.     
  700. \{ \ts bu Sample Script\} :
  701.     
  702. 'area';
  703. '\{ \tc 15 greencont 89\} ';
  704.     
  705. See Also: \{ \ts b \link "bluecont" "hlp_arexx5/bluecont"
  706.           \link "redcont " "hlp_arexx10/redcont"\}
  707.               
  708. * User Interface: \{ \tc 15    Process Panel
  709.                         R,G,B Corrections
  710.                             Green Cont.\}
  711.  
  712. \endnode
  713.  
  714. \node "gray"
  715. \title "Gray"
  716. \next "grid"
  717. \prev "greencont"
  718. \{ \tc 15 Gray \} - Gray correction.
  719.     
  720. Analyzes a selected area and uses it's average to perform a gray correction
  721. on the entire image.
  722.     
  723. \nw    
  724. Usage - '\{ \tc 15 gray\} '
  725.     
  726. \{ \ts bu Sample Script\} :
  727.     
  728. 'area';
  729. '\{ \tc 15 gray\} ';
  730.     
  731. See Also: \{ \ts b \link "balance" "hlp_arexx5/balance"\}
  732.     
  733. * User Interface: \{ \tc 15   Process Panel
  734.                       Standard Adjustments
  735.                            Gray Balance\}
  736.     
  737. \endnode
  738.  
  739. \node "grid"
  740. \title "Grid"
  741. \next "highpass"
  742. \prev "gray"
  743. \{ \tc 15 Grid \} - Allows user to set up a grid.
  744.  
  745. \nw    
  746. Usage - '\{ \tc 15 grid <on> <xgrid> <ygrid> <xoff> <yoff>\} '
  747.         '\{ \tc 15 grid <off> [xgrid] [ygrid] [xoffs] [yoffs]\} '
  748.             
  749.         \{ \tc 15 On:      0 = OFF, 1 = ON
  750.         Xgrid:   X grid spacing
  751.         Ygrid:   Y grid spacing
  752.         Xoffs:   Left edge offset (must be less than Xgrid)
  753.         Yoffs:   Top edge offset  (must be less than Ygrin)\}
  754.             
  755. \{ \ts bu Sample Script\} :
  756.      
  757. '\{ \tc 15 grid 1 10 10 5 5\} ';
  758. 'area'; 
  759. 'contrast 80';
  760.     
  761. \endnode
  762.  
  763. \node "highpass"
  764. \title "High-Pass Filter"
  765. \next "hist"
  766. \prev "grid"
  767. \{ \tc 15 Highpass \} - The equivalant of an electronic high-pass filter.
  768.        
  769. \nw    
  770. Usage - '\{ \tc 15 highpass <effect> <direction>\} '
  771.     
  772. \{ \tc 15 Effect:    0  - 100%
  773. Direction: 1 = horizontal, 2 = vertical, 3 = both\}
  774.     
  775. \{ \ts bu Sample Script\} :
  776.     
  777. 'area';
  778. options results;
  779. askprop effect 50 0 100;
  780. effect = result;
  781. 'gadgets "Filter","Horizontal" "Filter","Vertical" "Filter",
  782.      "Horizontal and Vertical"'; 
  783. direction = result;
  784. say result;
  785. options;
  786. '\{ \tc 15 highpass\} ' effect direction;
  787.  
  788. See Also: \{ \ts b \link "lowpass" "hlp_arexx8/lowpass"\}
  789.     
  790. * User Interface: \{ \tc 15   Process Panel
  791.                         Filters
  792.                             High Pass\}
  793.  
  794. \endnode
  795.  
  796. \node "hist"
  797. \title "Histogram"
  798. \next "horflip"
  799. \prev "highpass"
  800. \{ \tc 15 Hist \} - Performs a histogram equalization.
  801.  
  802. Reorganizes the color and/or gray scale distribution in a selected region and
  803. reorganizes it for statistically even distribution throughout the available
  804. color range.  Some color information maybe lost.
  805.     
  806. \nw    
  807. Usage - '\{ \tc 15 hist\} '
  808.     
  809. \{ \ts bu Sample Script\} :
  810.     
  811. 'area';
  812. '\{ \tc 15 hist\} ';
  813.     
  814. * User Interface: \{ \tc 15   Process Panel
  815.                         Standard Adjustments
  816.                             Histogram Equalize\}
  817.  
  818. \endnode
  819.  
  820. \node "horflip"
  821. \title "Horizontal Flip"
  822. \next "hue"
  823. \prev "hist"
  824. \{ \tc 15 Horflip \} - Flips each line in a selected area horizontally.
  825.  
  826. \nw    
  827. Usage - '\{ \tc 15 horflip [mask flip = 1 or 0]\} '
  828.  
  829. The optional mask flip parameter allows you to flip the image's mask or to
  830. flip the image within its mask.  A setting of 1 or ON will flip the image and
  831. the mask, and a setting of 0 or OFF will flip the image within the mask.
  832.  
  833. \{ \ts bu Sample Script\} :
  834.     
  835. 'area';
  836. '\{ \tc 15 horflip\} ';
  837.     
  838. See Also: \{ \ts b \link "vertflip" "hlp_arexx11/vertflip"\}
  839.     
  840. * User Interface: \{ \tc 15    Process Panel
  841.                         Geometric Transformations
  842.                             Hor Flip\}
  843. \endnode
  844.  
  845. \node "hsvset"
  846. \title "HSV Set"
  847. \next "hue"
  848. \prev "horflip"
  849. \{ \tc 15 HSVset \} - This command is used to colorize an area based on Hue,
  850. Saturation, and Value settings.  The three HSV components can be applied
  851. togeather or separatly.  The Hue of an image can be thought of as color of a
  852. region.  The Saturation setting controls the richness or depth of the color,
  853. and the Value control adjusts the brightness of a color.
  854.  
  855. The HSV Set operation can also be used as a colorize operation.  The HSV
  856. controls can all be applied independently of one another.  This means that
  857. you can sipmply change the hue of a colored region, or change the hue and
  858. saturation of a grayscale image.  The application of the separate components
  859. of the HSV settings can have different effect on grayscale and color images.
  860. If you are going to colorize a grayscale image, you will need to apply both
  861. hue and saturation to the selected region.  You do not need to apply the
  862. value (brightness) to the selected area.  If you wish to change the hue or
  863. color of a color image you should apply only the hue setting or the hue and
  864. saturation.  Applying all three components in the same region will result in
  865. a simple HSV solid color fill.
  866.  
  867. \nw    
  868. Usage - '\{ \tc 15 hsvset H=<h> S=<s> V=<v>\} '
  869.  
  870. Where H, S, and V can all be applied independently.  Only the channels
  871. sepecified will be used.
  872.  
  873. \{ \ts bu Sample Script\} :
  874. /* arexx hsvset Example */
  875. address('IM_Port');
  876. 'area';
  877. '\{ \tc 15 hsvset H=265 S=100\} ';
  878. 'finish';
  879.  
  880. * User Interface: \{ \tc 15    Process Panel
  881.                         Standard Adjustments
  882.                             HSV Set\}
  883.  
  884. \endnode
  885.  
  886. \node "hue"
  887. \title "Hue"
  888. \next "imageaspect"
  889. \prev "hsvset"
  890. \{ \tc 15 Hue \} - Changes the hue of a selected region.
  891.  
  892. \nw    
  893. Usage - '\{ \tc 15 hue <degrees>\} '
  894.  
  895. \{ \tc 15 Degrees: Change in hue from -180 to +180\}
  896.     
  897. \{ \ts bu Sample Script\} :
  898.  
  899. 'area';
  900. options results;
  901. 'askprop Degrees: 0 -180 180';
  902. degrees = results;
  903. options;
  904. '\{ \tc 15 hue\} ' degrees;
  905.     
  906. * User Interface: \{ \tc 15    Process Panel
  907.                         Standard Adjustments
  908.                             Adjust Hue\}
  909.     
  910. \endnode
  911.  
  912. \node "imageaspect"
  913. \title "Image Aspect"
  914. \next "imagedefs"
  915. \prev "hue"
  916. \{ \tc 15 Imageaspect \} - Reports aspect ratio of an image.
  917.  
  918. \nw    
  919. Usage - '\{ \tc 15 imageaspect <buffernumb>\} '
  920.        
  921. \{ \ts bu Sample Script\} :
  922.      
  923. options results;
  924. 'current';
  925. info = result;
  926. parse var info
  927. bname','bnumber','xdim','ydim','xdimydim','memused','parentname',
  928.   'parentnumber;
  929. '\{ \tc 15 imageaspect\} ' bnumber; 
  930. options;   
  931.  
  932. \endnode
  933.  
  934. \node "imagedefs"
  935. \title "Imagedefs"
  936. \next "imageext"
  937. \prev "imageaspect"
  938. \{ \tc 15 Imagedefs \} -  Returns path and extension of a saved image.
  939.  
  940. \nw    
  941. Usage - '\{ \tc 15 imagedefs\} '
  942.     
  943. \{ \ts bu Sample Script\} :
  944.     
  945. options results;
  946. '\{ \tc 15 imagedefs\} '
  947. info = result;
  948. parse var info path ','extension;
  949. options;
  950.  
  951. See also: \{ \ts b \link "blenddefs  " "hlp_arexx5/blenddefs"
  952.           \link "macrodefs  " "hlp_arexx8/macrodefs"
  953.           \link "palettedefs" "hlp_arexx9/palettedefs"
  954.           \link "renderdefs " "hlp_arexx10/renderdefs"\}
  955.  
  956. \endnode
  957.  
  958. \node "imageext"
  959. \title "Image Extension"
  960. \next "imagetofilm"
  961. \prev "imagedefs"
  962. \{ \tc 15 Imageext \} - Sets a new extension for saving and loading files.
  963.         
  964. \nw    
  965. Usage - '\{ \tc 15 imageext <newext>\} '
  966.     
  967. \{ \ts bu Sample Script\} :
  968.           
  969. options results;
  970. 'askstring "New Extension:" "img"'name;
  971. name = result;
  972. options;
  973. '\{ \tc 15 imageext\} ' name;         
  974.  
  975. See Also: \{ \ts b \link "blendext  " "hlp_arexx5/blendext
  976.           \link "macroext  " "hlp_arexx8/macroext"
  977.           \link "paletteext" "hlp_arexx9/paletteext"   
  978.           \link "renderext " "hlp_arexx10/renderext"\}
  979.                 
  980. * User Interface: \{ \tc 15  Setup Panel
  981.                        Image Ext\}
  982.                            
  983. \endnode
  984.  
  985. \node "imagetofilm"
  986. \title "Imagetofilm"
  987. \next "imagepath"
  988. \prev "imageext"
  989. \{ \tc 15 Imagetofilm \} - Inserts the selected buffer into the filmstrip.
  990.  
  991. This will have no effect if the filmstrip is not on.
  992.  
  993. \nw    
  994. Usage - '\{ \tc 15 imagetofilm <buffer number>\} '
  995.     
  996. \{ \ts bu Sample Script\} :   
  997.     
  998. '\{ \tc 15 imagetofilm 3\} ';
  999.  
  1000. \endnode
  1001.  
  1002. \node "imagepath"
  1003. \title "Image Path"
  1004. \next "imageplace"
  1005. \prev "imagetofilm"
  1006. \{ \tc 15 Imagepath \} - Sets a new path for saving and loading files.
  1007.  
  1008. \nw    
  1009. Usage - '\{ \tc 15 imagepath <newpath>\} '
  1010.     
  1011. \{ \ts bu Sample Script\} :
  1012.    
  1013. '\{ \tc 15 imagepath work:images\} ';
  1014.     
  1015. See Also:   \{ \ts b \link "blendpath  " "hlp_arexx5/blendpath" 
  1016.             \link "macropath  " "hlp_arexx8/macropath"
  1017.             \link "palettepath" "hlp_arexx9/palettepath"
  1018.             \link "renderpath " "hlp_arexx10/renderpath"\}
  1019.  
  1020. * User Interface: \{ \tc 15    Setup Panel
  1021.                           Image Path\}
  1022.  
  1023. \endnode
  1024.  
  1025. \node "imageplace"
  1026. \title "Imageplace"
  1027. \next "imtofront"
  1028. \prev "imagepath"
  1029. \{ \tc 15 Imageplace \} - Allows the user to specify the state of a buffer
  1030. based on its buffer number.  This is similar to the \{ \tc 15 'userload' \}
  1031. command, but uses the buffer number instead of the buffer name.
  1032.  
  1033. \nw    
  1034. Usage - '\{ \tc 15 imageplace <Buffernumber>\} '
  1035.     
  1036. \{ \ts bu Sample Script\} :
  1037.    
  1038. '\{ \tc 15 imageplace 3\} ';
  1039.  
  1040. \endnode
  1041.  
  1042. \node "imtofront"
  1043. \title "Imagemaster to Front"
  1044. \next "iptofront"
  1045. \prev "imageplace"
  1046. \{ \tc 15 Imtofront \} - Brings the Imagemaster screens to the front.
  1047.  
  1048. When used as the last command in a script the main panel is activated, just
  1049. as if the user clicked in it.  Useful with the Multi-Frame Sequencer.
  1050.  
  1051. \nw    
  1052. Usage - '\{ \tc 15 imtofront\} '
  1053.     
  1054. \{ \ts bu Sample Script\} :   
  1055.     
  1056. '\{ \tc 15 imtofront\} ';
  1057.  
  1058. \endnode
  1059.  
  1060. \node "iptofront"
  1061. \title "iptofront"
  1062. \next "ishape"
  1063. \prev "imtofront"
  1064. \{ \tc 15 Iptofront \} - Brings the Imagemaster screens to the front.
  1065.  
  1066. When used as the last command in a script the main panel is activated, just
  1067. as if the user clicked in it.  Useful with the Multi-Frame Sequencer.
  1068.  
  1069. \nw    
  1070. Usage - '\{ \tc 15 imtofront\} '
  1071.     
  1072. \{ \ts bu Sample Script\} :   
  1073.     
  1074. '\{ \tc 15 iptofront\} ';
  1075.  
  1076. \endnode
  1077.  
  1078. \node "ishape"
  1079. \title "ishape"
  1080. \next ""
  1081. \prev "iptofront"
  1082. \{ \tc 15 Ishape \} - The ishape command allows you to specify an IShape to
  1083. be painted in the current image.  Tje command allows you to specify the size
  1084. and postion of the IShape by setting an inital and terminating X and Y
  1085. values.  The IShape will not be drawn unless the stroke command is called.
  1086. You can also use the loadishape command to specify a new ishape.
  1087.  
  1088. \nw    
  1089. Usage - '\{ \tc 15 ishape <x1> <y1> <x2> <y2>\} '
  1090.  
  1091. Where x1 and y1 are the intial positon for the IShape, and x2 and y2 are the
  1092. ending position for the IShape.
  1093.  
  1094. \{ \ts bu Sample Script\} :
  1095. /* arexx ishape Example */
  1096. address('IM_Port');
  1097. '\{ \tc 15 ishape 0 0 150 150\} ';
  1098. 'stroke';
  1099. 'finish';
  1100.  
  1101. \endnode
  1102.  
  1103.  
  1104.